home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / libelfutil / xlate_pro_add_reg_info.z / xlate_pro_add_reg_info
Text File  |  1998-10-30  |  11KB  |  198 lines
  1.  
  2.  
  3.  
  4. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____RRRREEEEGGGG____IIIINNNNFFFFOOOO((((3333EEEE))))                          XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____RRRREEEEGGGG____IIIINNNNFFFFOOOO((((3333EEEE))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______aaaa_dddd_dddd______rrrr_eeee_gggg______iiii_nnnn_ffff_oooo - add register change information
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_eeee_llll_ffff_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_eeee_llll_ffff_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  16.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_mmmm_pppp_llll_rrrr_ssss_////_xxxx_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  17.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_XXXX_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  18.      _iiii_nnnn_tttt _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______aaaa_dddd_dddd______rrrr_eeee_gggg______iiii_nnnn_ffff_oooo_((((_xxxx_llll_aaaa_tttt_eeee______tttt_aaaa_bbbb_llll_eeee______pppp_rrrr_oooo _pppp_rrrr_oooo______tttt_aaaa_bbbb_llll_eeee______pppp_tttt_rrrr_,,,,
  19.        _DDDD_wwww_aaaa_rrrr_ffff______SSSS_mmmm_aaaa_llll_llll _oooo_pppp_,,,,
  20.        _DDDD_wwww_aaaa_rrrr_ffff______UUUU_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _vvvv_aaaa_llll_1111_,,,,
  21.        _DDDD_wwww_aaaa_rrrr_ffff______UUUU_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _vvvv_aaaa_llll_2222
  22.      _))))_;;;;
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      _x_l_a_t_e__p_r_o__a_d_d__r_e_g__i_n_f_o is used to put register information into the xlate
  26.      data stream.  The register information normally specifies how a debugger
  27.      or other tool can get to registers which have been copied into shadow
  28.      register locations so a transforming tool (_p_i_x_i_e(1) normally) can use the
  29.      registers for its own purposes.  _p_r_o__t_a_b_l_e__p_t_r must be a valid open
  30.      producer translate table handle.
  31.  
  32.      _o_p      Pass in an frame operation code in the set allowed.  An example
  33.              is _D_W__C_F_A__o_f_f_s_e_t__e_x_t_e_n_d_e_d.  Makes no difference if the op is an
  34.              extended op code or not (see section 6.4 of the DWARF document).
  35.              The arguments _v_a_l_1 and _v_a_l_2 are the "arguments" as described by
  36.              section 6.4.2 of the DWARF document.
  37.  
  38.      _v_a_l_1    Is a value whose meaning depends on _o_p . (see section 6.4 of the
  39.              DWARF document).
  40.  
  41.      _v_a_l_2    Is a value whose meaning depends on _o_p . (see section 6.4 of the
  42.              DWARF document).
  43.  
  44.      A typical use for _p_i_x_i_e would be to first set the CFA using
  45.      _D_W__C_F_A__o_f_f_s_e_t__e_x_t_e_n_d_e_d and naming the register or location to use as a
  46.      base address and then set up a rule for each particular register using,
  47.      for example, _D_W__C_F_A__o_f_f_s_e_t or_D_W__C_F_A__o_f_f_s_e_t__e_x_t_e_n_d_e_d and giving the
  48.      particular offset of the shadow register value.
  49.  
  50.      An example follows:
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____RRRREEEEGGGG____IIIINNNNFFFFOOOO((((3333EEEE))))                          XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____RRRREEEEGGGG____IIIINNNNFFFFOOOO((((3333EEEE))))
  70.  
  71.  
  72.  
  73.           _rrrr_eeee_ssss_uuuu_llll_tttt _==== _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______aaaa_dddd_dddd______rrrr_eeee_gggg______iiii_nnnn_ffff_oooo_((((_pppp_rrrr_oooo______tttt_aaaa_bbbb_llll_eeee______pppp_tttt_rrrr_,,,,
  74.             _DDDD_WWWW______CCCC_FFFF_AAAA______dddd_eeee_ffff______cccc_ffff_aaaa_,,,,
  75.              _DDDD_WWWW______FFFF_RRRR_AAAA_MMMM_EEEE______RRRR_EEEE_GGGG_8888_,,,, _////_**** _rrrr_8888 _iiii_ssss _oooo_uuuu_rrrr _bbbb_aaaa_ssss_eeee _rrrr_eeee_gggg _****_////
  76.              _0000_))))_;;;;
  77.           _rrrr_eeee_ssss_uuuu_llll_tttt _==== _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______aaaa_dddd_dddd______rrrr_eeee_gggg______iiii_nnnn_ffff_oooo_((((_pppp_rrrr_oooo______tttt_aaaa_bbbb_llll_eeee______pppp_tttt_rrrr_,,,,
  78.             _DDDD_WWWW______CCCC_FFFF_AAAA______oooo_ffff_ffff_ssss_eeee_tttt______eeee_xxxx_tttt_eeee_nnnn_dddd_eeee_dddd_,,,,
  79.              _DDDD_WWWW______FFFF_RRRR_AAAA_MMMM_EEEE______RRRR_EEEE_GGGG_3333_1111_,,,, _////_**** _rrrr_3333_1111 _uuuu_ssss_uuuu_rrrr_pppp_eeee_dddd _bbbb_yyyy _pppp_iiii_xxxx_iiii_eeee _****_////
  80.              _rrrr_3333_1111______oooo_ffff_ffff_ssss_eeee_tttt_))))_;;;;
  81.           _rrrr_eeee_ssss_uuuu_llll_tttt _==== _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______aaaa_dddd_dddd______rrrr_eeee_gggg______iiii_nnnn_ffff_oooo_((((_pppp_rrrr_oooo______tttt_aaaa_bbbb_llll_eeee______pppp_tttt_rrrr_,,,,
  82.             _DDDD_WWWW______CCCC_FFFF_AAAA______oooo_ffff_ffff_ssss_eeee_tttt______eeee_xxxx_tttt_eeee_nnnn_dddd_eeee_dddd_,,,,
  83.              _DDDD_WWWW______FFFF_RRRR_AAAA_MMMM_EEEE______RRRR_EEEE_GGGG_1111_7777_,,,, _////_**** _rrrr_1111_7777 _uuuu_ssss_uuuu_rrrr_pppp_eeee_dddd _bbbb_yyyy _pppp_iiii_xxxx_iiii_eeee _****_////
  84.              _rrrr_1111_7777______oooo_ffff_ffff_ssss_eeee_tttt_))))_;;;;
  85.  
  86. FFFFIIIILLLLEEEESSSS
  87.      /usr/include/libXlate.h
  88.      /usr/include/cmplrs/xlate.h
  89.      /usr/include/elf.h
  90.      /usr/include/dwarf.h
  91.      /usr/include/libdwarf.h
  92.      /usr/lib/libelfutil.a
  93.  
  94. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  95.      Returns XLATE_TB_STATUS_NO_ERROR (0) on success.  In case of error, a
  96.      negative number is returned indicating the error.  In case of error,
  97.      nothing is returned thru the pointer arguments which would return values
  98.      on successful call (values might have been changed thru these pointers
  99.      but any such changes are not meaningful).
  100.  
  101.      Error codes that may be returned:
  102.  
  103.      _X_L_A_T_E__T_B__S_T_A_T_U_S__I_N_V_A_L_I_D__T_A_B_L_E
  104.              means that the _p_r_o__t_a_b_l_e__p_t_r is not a valid open producer handle.
  105.              Or it might mean there has been some malloc arena corruption or
  106.              other application bug leading to overwriting of the first 4 bytes
  107.              of the data pointed at by _p_r_o__t_a_b_l_e__p_t_r.
  108.  
  109.      _X_L_A_T_E__T_B__S_T_A_T_U_S__A_D_D__T_O_O__L_A_T_E
  110.              means that the call has occurred after a call to
  111.              _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r which is not allowed.  call
  112.              _x_l_a_t_e__p_r_o__a_d_d__r_e_g__i_n_f_o before calling _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r.
  113.  
  114.      _X_L_A_T_E__T_B__S_T_A_T_U_S__B_A_D__R_E_G__V_A_L
  115.              means that the register number passed in will not fit using the
  116.              particular _o_p used in the call.
  117.  
  118.      _X_L_A_T_E__T_B__S_T_A_T_U_S__A_L_L_O_C__F_A_I_L
  119.              means _r_e_a_l_l_o_c(3) failed when adding the requested register
  120.              operation.
  121.  
  122.      _X_L_A_T_E__T_B__S_T_A_T_U_S__B_A_D__R_E_G__O_P
  123.              means the _o_p passed in is not one of the set of frame operations
  124.              supported by _x_l_a_t_e__p_r_o__a_d_d__r_e_g__i_n_f_o.
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____RRRREEEEGGGG____IIIINNNNFFFFOOOO((((3333EEEE))))                          XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____RRRREEEEGGGG____IIIINNNNFFFFOOOO((((3333EEEE))))
  136.  
  137.  
  138.  
  139. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  140.      libelfutil(5), xlate(4), xlate_pro_init(3e), xlate_pro_finish(3e) DWARF
  141.      Debugging Information Format (Version 2)
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.